Entrée de Registre Reports

Plusieurs entrées de Registre sont nécessaires pour générer un rapport :

- définit l'action pour générer chaque type de rapport

Spécifiez une association entre un type de rapport interne (par exemple Crystal, Excel) et l'action à effectuer lorsque le rapport est exécuté dans le client.

Description

EMu fournit plusieurs formats de sortie dans le cadre de son environnement de reporting standard. Chaque type de rapport a un nom de rapport qui l'identifie dans le système (par exemple Crystal, Excel), et un format de sortie qui définit ce que le système de rapport doit faire pour exécuter ce dernier.

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Action
Clé 5 report
Valeur format
System Setting Reports Action report format

où :

report

est le nom du type de rapport, ex. Crystal, Excel.

format

est dans le format :

[action][location][options]

où :

action

peut être :

Sauvegarder

Le produit de sortie est enregistré dans un fichier. location définit où le fichier doit être sauvegardé. Si cette option est utilisée, le produit de sortie du rapport sera placé dans le fichier comme spécifié. Il n'y a pas d'options pour cette action.

Launch

Le rapport de sortie est sauvegardé dans un fichier comme spécifié dans location. Quand la sauvegarde est terminée, options spécifie quel fichier doit être lancé. L'application qui lance le fichier est celle qui est paramétrée dans la base de Registres Windows pour ce type de fichier. Donc, c'est la même que lorsqu'on double-clique sur le fichier dans l'explorateur de Windows.

La section options spécifie les fichiers à lancer. Il peut s’agir de chemins codés en dur ou d’emplacements réservés de la forme %n, où n est le numéro du fichier dans la liste des fichiers sauvegardés. Donc, %1 est le premier fichier sauvegardé, %2 est le second et ainsi de suite. Si vous spécifiez un emplacement réservé supérieur au nombre de fichiers générés, il est ignoré en silence. L'option %r est remplacée au moment de l'exécution par le nom du rapport à exécuter.

Run

Le produit de sortie est sauvegardé à l'emplacement spécifié dans location. Une fois que le produit de sortie est sauvegardé, la section options définit la commande côté client à exécuter. Toutes les options disponibles pour Launch le sont aussi pour Run.

location

peut être :

Temp

Le fichier de sortie est sauvegardé dans la zone de fichier temporaire Windows (pour Windows, d'habitude c'est C:\Winnt\Temp)). Le nom de fichier utilisé est le même que celui créé sur le serveur. Il n'y a pas de saisie demandée à l'utilisateur.

ODBC

Le fichier de sortie est sauvegardé sous ODBC Data Source pour le module en cours. Il est supposé que le format du fichier est compatible pour l'utilisation de Microsoft ODBC Text Driver.

Fichier

Chaque fichier est copié depuis le serveur sur le client, la boîte Enregistrer Sous apparaîtra permettant à l'utilisateur de spécifier où le fichier doit être copié.

Directory

Lorsque le premier fichier sera copié depuis le client sur le serveur, il sera demandé à l'utilisateur de spécifier un répertoire de sauvegarde de tous les fichiers. Le nom de fichier utilisé est le même que celui créé sur le serveur.

Cette entrée spécifie une action pour le lancement de Crystal report :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Action
Clé 5 Crystal
Valeur Run ODBC Crystal/crystal.exe %r

Dans cet exemple, lorsque Crystal report est lancé, le produit de sortie est conservé dans ODBC Data Source du module en cours. Si un utilisateur appelle un rapport Crystal report depuis le module Personnes / Organisations, le produit de sortie est conservé sous ODBC Data Source qui existe sur le serveur pour le module eparties. L'exécutable Crystal est appelé sur la machine cliente et prend en compte le nom du rapport à lancer.

Cette entrée spécifie une action pour le lancement des rapports Excel :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Action
Clé 5 Excel
Valeur Launch ODBC %r

Dans cet exemple, lorsque Excel report est lancé, le produit de sortie est conservé dans ODBC Data Source du module en cours. Si un utilisateur appelle un rapport Excel depuis le module Personnes / Organisations, le produit de sortie est conservé sous ODBC Data Source qui existe sur la machine pour le module eparties. Le fichier de sortie a une extension .xls, comme défini par l'entrée de Registre Report|Extension. Le nom de fichier de sortie est substitué par %r, et Excel est lancé comme si un utilisateur double-cliquait sur un fichier .xls dans l'Explorateur Windows.

- associe l'extension du rapport à une application

Spécifiez une association entre un type de rapport et son extension (type de fichiers).

Description

EMu fournit plusieurs formats de sortie dans le cadre de son environnement de reporting standard. Chaque type de rapport possède un nom de rapport qui l'identifie dans le système et un suffixe qui est l'extension de fichier à ajouter au nom du fichier de sortie lorsqu'il est généré par le système. Le suffixe sera généralement l'extension de fichier associée au programme de destination de visualisation du rapport (par exemple, .xls pour un rapport Excel ou Microsoft ADO).

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Extension
Clé 5 report
Valeur suffix
System Setting Reports Extension report suffix

où :

report

est le nom du type de rapport, ex. :

  • ArcExplorer
  • Crystal
  • Crystal ADO
  • Excel
  • Microsoft ADO
  • Power Point
  • Word
  • Worperfect

suffix

est le nom de l'extension de fichier associé au type de rapport ex. .xls pour un rapport Excel ou rapport Microsoft ADO; .doc pour un rapport Word.

Cette entrée spécifie que lors de la création d'un rapport du type Word le nom du fichier de sortie doit avoir .doc annexé à la fin :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Extension
Clé 5 Word
Valeur .doc

Cette entrée spécifie que lors de la création d'un rapport du type Crystal le nom du fichier de sortie doit avoir .rpt annexé à la fin :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Extension
Clé 5 Crystal
Valeur .rpt

Cette entrée spécifie que lors de la création d'un rapport du type Microsoft ADO le nom du fichier de sortie doit avoir .xls annexé à la fin :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Extension
Clé 5 Microsoft ADO
Valeur .xls

Note: Lorsque vous créez un nouveau rapport Microsoft ADO dans EMu et que vous l'exécutez pour la première fois, Microsoft Excel (dans ce cas) s'ouvrira par défaut. Si vous avez indiqué .doc comme valeur, Microsoft Word s'ouvrira par défaut.

- définit un filtre média qui convertit l'emplacement de sauvegarde d'une image du serveur vers le client

Spécifiez le lancement de filtres qui doit précéder l'envoi d'un rapport vers le client.

Description

L’outil de rapport standard d'EMu génère des rapports de données au format XML. Un filtre hébergé sur le serveur peut traduire le XML dans un autre format si nécessaire. Le but de cette entrée est de définir un filtre à appliquer au XML avant qu'il ne soit envoyé au client. Chaque type de rapport peut être associé à un filtre. Le filtre doit être installé sur le serveur dans ~/utils/filtername.

Cette entrée est optionnelle. La plupart des types de rapports sont sauvegardés sur la machine cliente sous ODBC Data Source pour le module en cours et sont traduits en ODBC.

Ce filtre est exécuté sur le serveur après tout Media Filter.

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Filter
Clé 5 report
Valeur filtre
System Setting Reports Filter report filtre

où :

report

est le nom du type de rapport, ex. Crystal, Excel.

filtre

est le nom du filtre qui s'applique au fichier XML avant qu'il soit envoyé vers le client. Le filtre doit être installé sur le serveur dans ~/utils/filtername.

Cette entrée spécifie un filtre texxmlodbc qui traduit les rapports Crystal reports en ODBC avant leurs envois vers la machine cliente :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Filter
Clé 5 Crystal
Valeur texxmlodbc
- définit un filtre média qui convertit l'emplacement de sauvegarde d'une image du serveur vers le client

Spécifiez un filtre qui traduit le chemin d'accès du fichier image depuis le serveur vers le client.

Description

Lorsqu'un rapport est lancé, les images qui sont affichées dans le rapport ont leur chemin d'accès mémorisé dans le champ Multimédia. Toutefois, ce chemin oriente vers la zone de sauvegarde du serveur. Le but de cette entrée est de définir un filtre qui traduise ce chemin vers un emplacement côté machine cliente, permettant au programme d'édition des rapports de trouver et afficher l'image.

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Media Filter
Clé 5 rapport ou Default
Valeur filtre
System Setting Reports Media Filter rapport ou Default filtre

où :

report

est le nom du type de rapport, ex. Crystal, Excel; ou utilisez Default pour tous les types de rapport.

filtre

est le nom du filtre qui est lancé sur le serveur, situé dans ~/utils/.

Cette entrée spécifie un filtre appelé reportsmedia pour tous les rapports Crystal :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Media Filter
Clé 5 Crystal
Valeur reportsmedia

Cette entrée spécifie que tous les types de rapports sans leur propre entrée de Registre Media Filter seront filtrés avec reportsmedia :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Media Filter
Clé 5 Default
Valeur reportsmedia
- définit une association entre un type de rapport interne et le nom à afficher chez le client

Spécifiez une association entre un type de rapport (ex. Crystal) et le nom à afficher dans le client.

Description

EMu fournit plusieurs formats de sortie dans le cadre de son environnement de reporting standard. Chaque type de rapport a un nom de rapport qui l'identifie dans le système (par exemple, Word) et un nom d'affichage apparaissant dans le client (par exemple, MS Word). Une liste des types de rapports existants peut être consultée dans la fenêtre Propriétés du rapport (sélectionnez Rapports dans l'onglet Accueil du ruban, faites un clic droit sur un rapport, sélectionnez Propriétés et cliquez sur la liste déroulante Type). Une entrée Reports Name existe pour chaque type de rapport.

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Name
Clé 5 report
Valeur display (affichage)
System Setting Reports Name report display (affichage)

où :

report

est le nom du type de rapport, ex. Crystal, Excel.

display (affichage)

est le nom d'affichage qui apparaît chez le client (ex. Excel).

Cette entrée spécifie qu'un rapport de type Word aura Microsoft Word comme nom l'affichage :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Name
Clé 5 Word
Valeur Microsoft Word
- spécifie le format d'export des données pour un type d'enregistrement

Associe un type de rapport (par exemple : Crystal Report) à un format d'exportation (par exemple l’ensemble de données ODBC, l’ensemble d’enregistrement ADO).

Description

Le Sous-système de rapport d'EMu a été modifié avec la version 5.0 afin de contourner certains filtres lorsqu'un rapport Crystal Report ou Microsoft (Excel, Word, etc.) est généré à partir d'EMu. Le contournement du filtre améliore la génération de rapports et les performances.

Le Sous-système de rapport a été modifié de deux manières principales :

  • Crystal Reports.

    Afin de créer et de générer un rapport, Crystal Reports requiert un fichier .csv contenant les données EMu exportées. Dans les versions précédentes d'EMu, les données étaient exportées au format XML puis filtrées pour générer un ou plusieurs fichiers .csv conformes à ODBC. Le processus de filtrage a été contourné et EMu est maintenant capable de générer directement la source de données ODBC.

    Note: Ce changement n'affecte pas la façon dont vous élaborez un rapport Crystal Report, la source de données ODBC (un ou plusieurs fichiers .csv) produite par EMu est simplement générée de façon beaucoup plus efficace. Avec l'entrée de Registre Reports|Type, il est possible de spécifier si le processus de filtre est contourné ou non.

  • Deux nouveaux formats de rapport ont été introduits. Ils permettent d'établir des rapports directement vers un objet ActiveX Data Objects (ADO) RecordSet (XML) plutôt que vers une source de données ODBC (CSV). Les nouvelles options de rapport sont les suivantes :
    • Crystal ADO : génère un rapport en utilisant ADO RecordSets pour Crystal (accessible via le connecteur ADO de Crystal).
    • Microsoft ADO : génère un rapport avec ADO RecordSets pour les produits Microsoft.

Utilisation

Cette entrée de Registre est attribuée au niveau du système uniquement :

Clé Système
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Type
Clé 5 report
Valeur valeur
System Setting Reports Type report valeur

où :

report

est le nom que nous avons utilisé pour un type de rapport, par exemple Crystal CSV, Crystal ADO, Microsoft ADO, etc.

Tip: Le nom est spécifié dans une entrée de Registre Reports|Name.

valeur

est :

0

où le rapport est Crystal CSV (ou un type de rapport Crystal équivalent), les données sont générées comme dans EMu 4.3 et ses versions précédentes : les données sont exportées en XML puis filtrées pour générer un ou plusieurs fichiers .csv conformes avec ODBC.

Note: Si cette entrée est absente, une valeur de 0 est présumée.

1

où le rapport est Crystal CSV (ou un type de rapport Crystal équivalent), le processus de filtre est contourné et EMu génère directement la source de données ODBC.

2

lorsque le rapport est Crystal ADO (ou un type de rapport Crystal ADO équivalent), les données sont générées sous la forme Crystal ADO RecordSet (c'est-à-dire qu'elles sont rapportées directement vers un objet ActiveX Data Objects RecordSet plutôt que dans une source de données ODBC).

3

lorsque le rapport est Microsoft ADO (ou un type de rapport Microsoft ADO équivalent), les données sont générées sous la forme Microsoft ADO RecordSet (c'est-à-dire qu'elles sont rapportées directement vers un objet ActiveX Data Objects RecordSet plutôt que dans une source de données ODBC).

Cette entrée spécifie que le type de rapport que nous avons appelé Crystal CSV génère des données en contournant le processus de filtre et en générant directement la source de données ODBC :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Type
Clé 5 Crystal CSV
Valeur 1

Cette entrée spécifie que le type de rapport que nous avons appelé Crystal ADO génère des données dans l’ensemble d'enregistrements Crystal ADO :

Clé Paramètre
Clé 1 System
Clé 2 Setting
Clé 3 Reports
Clé 4 Type
Clé 5 Crystal ADO
Valeur 2